delete variable
Type
command
Summary
Removes a variable contents from memory.
Syntax
delete {local | global | variable} {<variableName> | <arrayIndex>}
Description
Use the delete variable command to free memory used by a large variable. The delete variable command only removes the contents of the variable.
If you delete a key from an array variable, that element of the array no longer exists as part of the variable.
Local variables that are used within a handler are automatically deleted when the handler in which they are used exits.
Parameters
Name | Type | Description |
---|---|---|
variableName | The name of any local or global variable. | |
arrayIndex | array | A key of an array variable. If an arrayIndex is specified instead of a variable name, the delete variable command removes that element of the array, without deleting the rest of the elements in the array. |
Examples
local tVariable
delete local tVariable
global gArray
delete global gArray[17]
Related
command: global, delete, local
function: globalNames
glossary: key, handler, variable, exit, local variable, array, command
keyword: element
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile